Aviation API

(0 reviews)

17 Satellite Imagery

Satellite imagery uses satellite observation data collected from the Himawari-8 and GOES satellites to show cloud coverage globally. Images can be one of four types: visible, infrared, enhanced infrared and cloud top height and are available every 10 minutes.

17.1 Latest Image

This call requests the latest satellite image for the type and region requested. A link to the appropriate image will be returned.

17.1.1 API Call:

GET /aviation/satellite/{product}/{imagetype}/{region}/{resolution}/latest

17.1.2 Path Parameters:

Path Parameter	Example	Description
Product	himawari	The name of the satellite. See table below. This parameter is Mandatory.
Image type	vis	The type of image. Visible (vis), Infrared (ir), Infrared Enhanced (ire), and Cloud Top (ct). This parameter is Mandatory.
Region	nz-au	The region. See table below. This parameter is Mandatory.
Resolution	4km	The resolution of the image. This parameter is Mandatory.

17.1.3 Example:

This example would return the link to the latest satellite image over New Zealand and Australia in the visible spectrum at 4km resolution.

GET /aviation/satellite/himawari/vis/nz-au/4km/latest

17.1.4 API Response:

{
    "version":"1.0",
    "issue-time":"2018-10-11T22:20:14Z",
    "path":"/satellite/himawari/vis/nz-au/4km/latest",
    "response":[
        {
            "av:satellite-image-type":"vis",
            "av:satellite-region":"nz-au",
            "met:locator":"https://api.metservice.com/assets/aviation/satellite/himawari_vis_nzau_4km_201810112140.jpg",
            "met:product-name":"himawari",
            "av:satellite-resolution":"4km",
            "met:domain":"aviation",
            "met:valid-at":"2018-10-11T21:40:00Z"
        }
    ]
}

17.2 Images for last n hours

This call requests satellite images for the type and region specified that have a valid at time which is within the last n hours specified. A set of links will be returned for each image.

17.2.1 API Call:

GET /aviation/satellite/{product}/{imagetype}/{region}/{resolution}/last/{n}/hours

17.2.2 Path Parameters:

Path Parameter	Example	Description
Product	himawari	The name of the satellite. See table below. This parameter is Mandatory.
Image type	vis	The type of image. Visible (vis), Infrared (ir), Infrared Enhanced (ire), and Cloud Top (ct). This parameter is Mandatory.
Region	nz-au	The region. See table below. This parameter is Mandatory.
Resolution	4km	The resolution of the image. This parameter is Mandatory.
n	2	Hours for which data is required. This parameter is Mandatory.

17.2.3 Example:

This example would return links to the last 2 hours of satellite images over New Zealand and Australia in the visible spectrum at 4km resolution.

GET /aviation/satellite/himawari/vis/nz-au/4km/last/2/hours

17.2.4 API Response:

{
    "version":"1.0",
    "issue-time":"2018-10-11T22:36:37Z",
    "path":"/satellite/himawari/vis/nz-au/4km/last/2/hours",
    "response":[
        {
            "av:satellite-image-type":"vis",
            "av:satellite-region":"nz-au",
            "met:locator":"https://api.metservice.com/assets/aviation/satellite/himawari_vis_nzau_4km_201810112150.jpg",
            "met:product-name":"himawari",
            "av:satellite-resolution":"4km",
            "met:domain":"aviation",
            "met:valid-at":"2018-10-11T21:50:00Z"
        },
        {
            "av:satellite-image-type":"vis",
            "av:satellite-region":"nz-au",
            "met:locator":"https://api.metservice.com/assets/aviation/satellite/himawari_vis_nzau_4km_201810112140.jpg",
            "met:product-name":"himawari",
            "av:satellite-resolution":"4km",
            "met:domain":"aviation",
            "met:valid-at":"2018-10-11T21:40:00Z"
        },
        {
            "av:satellite-image-type":"vis",
            "av:satellite-region":"nz-au",
            "met:locator":"https://api.metservice.com/assets/aviation/satellite/himawari_vis_nzau_4km_201810112130.jpg",
            "met:product-name":"himawari",
            "av:satellite-resolution":"4km",
            "met:domain":"aviation",
            "met:valid-at":"2018-10-11T21:30:00Z"
        },
        {
            "av:satellite-image-type":"vis",
            "av:satellite-region":"nz-au",
            "met:locator":"https://api.metservice.com/assets/aviation/satellite/himawari_vis_nzau_4km_201810112120.jpg",
            "met:product-name":"himawari",
            "av:satellite-resolution":"4km",
            "met:domain":"aviation",
            "met:valid-at":"2018-10-11T21:20:00Z"
        },
        {
            "av:satellite-image-type":"vis",
            "av:satellite-region":"nz-au",
            "met:locator":"https://api.metservice.com/assets/aviation/satellite/himawari_vis_nzau_4km_201810112110.jpg",
            "met:product-name":"himawari",
            "av:satellite-resolution":"4km",
            "met:domain":"aviation",
            "met:valid-at":"2018-10-11T21:10:00Z"
        },
        {
            "av:satellite-image-type":"vis",
            "av:satellite-region":"nz-au",
            "met:locator":"https://api.metservice.com/assets/aviation/satellite/himawari_vis_nzau_4km_201810112100.jpg",
            "met:product-name":"himawari",
            "av:satellite-resolution":"4km",
            "met:domain":"aviation",
            "met:valid-at":"2018-10-11T21:00:00Z"
        },
        {
            "av:satellite-image-type":"vis",
            "av:satellite-region":"nz-au",
            "met:locator":"https://api.metservice.com/assets/aviation/satellite/himawari_vis_nzau_4km_201810112050.jpg",
            "met:product-name":"himawari",
            "av:satellite-resolution":"4km",
            "met:domain":"aviation",
            "met:valid-at":"2018-10-11T20:50:00Z"
        },
        {
            "av:satellite-image-type":"vis",
            "av:satellite-region":"nz-au",
            "met:locator":"https://api.metservice.com/assets/aviation/satellite/himawari_vis_nzau_4km_201810112040.jpg",
            "met:product-name":"himawari",
            "av:satellite-resolution":"4km",
            "met:domain":"aviation",
            "met:valid-at":"2018-10-11T20:40:00Z"
        }
    ]
}

17.2.5 Table of available satellite regions:

Product	Image Type	Region	Resolution	Description
himawari	vis	nz-au	4km	Visible light image over Australia and New Zealand
himawari	ir	nz-au	4km	Infrared over Australia and New Zealand
himawari	ire	nz	2km	Infrared Enhanced over New Zealand
himawari	vis	nz	2km	Visible light image over New Zealand
himawari	ct	as-za	4km	Cloud top image over Asia and the Pacific Ocean
himawari	ct	as	4km	Cloud top image over Asia
himawari	ct	nz-au	4km	Cloud top image over New Zealand and Australia
goes	ct	hl-us	4km	Cloud top image over Honolulu and the United States
himawari	ct	nz	4km	Cloud top image over New Zealand
himawari	ct	nz-hl	4km	Cloud top image over New Zealand and Honolulu
himawari	ct	nz-cn	4km	Cloud top image over New Zealand and China
goes	ct	nz-am.s	4km	Cloud top image over New Zealand and South America
goes	ct	nz-us	4km	Cloud top image over New Zealand and the United States
goes	ct	zn.s	4km	Cloud top image over the South Pacific Ocean
himawari	ct	zn.sw	4km	Cloud top image over the Southwest Pacific Ocean
himawari	ct	ts	4km	Cloud top image over the Tasman Sea
himawari	ct	tr	4km	Cloud top image over the Tropics
himawari	ct	au.w	4km	Cloud top image over Western Australia
himawari	ct	nz-ts	4km	Cloud top image over New Zealand and the Tasman Sea